Albatros — User Manual

Version 1.0.0 beta 12 · Windows, Linux, macOS

Author: Ing. Roberto Arato · Arato Ingegneria · aratoingegneria.it

Albatros is a program for email, calendar and tasks, and it also reads RSS feeds and newsgroups. It stays fast even with very large archives and finds any message instantly. Your mail stays on your computer, in ordinary files that you can copy and keep. Signing and encryption (OpenPGP and S/MIME) are built in, with no add-ons needed. The interface is available in nine languages: Italian, English, French, German, Spanish, Japanese, Chinese, Russian and Arabic. Albatros is conceived and developed by Ing. Roberto Arato (Arato Ingegneria). It also brings all your chats together in one tab: Delta Chat, IRC, XMPP, Matrix and Microsoft Teams.

Interface language. This manual names buttons, menus and fields exactly as they appear in the English interface. To change the language, see chapter 3.


Contents

  1. Requirements
  2. Installation
  3. First start
  4. Adding a mail account
  5. The main window
  6. Reading mail
  7. Writing and replying
  8. Organizing mail
  9. Searching
  10. Calendar
  11. Address book
  12. Importing from Thunderbird and Outlook
  13. Backup and transfer to another computer
  14. Settings
  15. Security and privacy
  16. Signing and encryption: OpenPGP and S/MIME
  17. Where your data is stored
  18. Keyboard shortcuts
  19. Troubleshooting

1. Requirements

SystemVersionPackage
Windows10 or 11, 64-bit, Intel/AMD processorAlbatros-1.0.0-beta.12-win-x64.zip
Windows11 on an ARM processor (for example Snapdragon)Albatros-1.0.0-beta.12-win-arm64.zip
Linuxrecent 64-bit distribution with a desktop environment, Intel/AMD processorAlbatros-1.0.0-beta.12-linux-x64.tar.gz
Linuxas above, 64-bit ARM processor (for example Raspberry Pi 4/5)Albatros-1.0.0-beta.12-linux-arm64.tar.gz
macOS14 (Sonoma) or later, Apple silicon (M1, M2, …)Albatros-1.0.0-beta.12-osx-arm64.tar.gz
macOS14 (Sonoma) or later, Intel processorAlbatros-1.0.0-beta.12-osx-x64.tar.gz

To install with a double-click there are also installers: Albatros-1.0.0-beta.12-linux-x64.deb (and linux-arm64.deb) for Debian, Ubuntu and Mint, and Albatros-1.0.0-beta.12-osx-arm64.dmg (and osx-x64.dmg) for macOS. They contain the same program as the packages above.

Nothing else needs to be installed: each package already contains everything it needs. If you don't know which processor you have, choose the Intel/AMD version (x64) for Windows and Linux; on a Mac, look in Apple menu → About This Mac ("Chip: Apple …" or "Processor: … Intel …"). The following chapters use the x64 package in their examples (or arm64 for the Mac): with the other version only the file name changes.

Disk space: about 50 MB for the program, plus the space for your mail (roughly what it takes on the server).

Each package also contains this manual in HTML, in all nine languages (for example "Albatros Manual (English).html"). Next to the packages there is a SHA256SUMS.txt file with the checksums: if you wish, you can check that the downloaded file is intact.


2. Installation

The simplest way: on Windows you unpack it and start it, on Linux (Debian, Ubuntu, Mint) and on macOS there is an installer. Alternatively, on every system, you unpack the archive and start it, even from a USB stick.

2.1 Windows

  1. Download Albatros-1.0.0-beta.12-win-x64.zip.
  2. Right-click the file → Extract All… and choose a folder, for example C:\Users\<name>\AppData\Local\Programs\ (just for you) or C:\Program Files\ (requires an administrator).
  3. Open the Albatros folder and double-click Albatros.exe.
  4. To keep it at hand: right-click Albatros.exe → Pin to Start, or Show more options → Send to → Desktop (create shortcut).

2.2 Linux

Debian, Ubuntu, Mint and derivatives: the .deb installer. Double-click Albatros-1.0.0-beta.12-linux-x64.deb (the system's installation program opens), or from a terminal:

sudo apt install ./Albatros-1.0.0-beta.12-linux-x64.deb

Albatros goes into /opt/albatros, appears in the applications menu (Internet/Office section) and from a terminal you start it with albatros. secret-tool is installed along with it, to keep passwords in the desktop keyring. To remove it: sudo apt remove albatros (mail and settings stay, see chapter 17). Installed this way, Albatros does not update by itself, because /opt belongs to the system: when there is a new version it tells you in the status bar and you install it with the new .deb.

All distributions: the .tar.gz archive. From a terminal (the ~/.local/opt folder is just an example):

mkdir -p ~/.local/opt
tar -xzf Albatros-1.0.0-beta.12-linux-x64.tar.gz -C ~/.local/opt

To start it from the applications menu:

mkdir -p ~/.local/bin ~/.local/share/applications ~/.local/share/icons/hicolor/256x256/apps
ln -sf ~/.local/opt/Albatros/Albatros ~/.local/bin/Albatros
cp ~/.local/opt/Albatros/albatros.desktop ~/.local/share/applications/
cp ~/.local/opt/Albatros/albatros.png ~/.local/share/icons/hicolor/256x256/apps/

Albatros now appears in the menu (Internet/Office section). From a terminal, start it with Albatros. If ~/.local/bin is not in your PATH, write the full path after Exec= in the albatros.desktop file.

Keeping passwords safe: Albatros uses your desktop keyring (GNOME Keyring, KWallet) through the secret-tool command. If it is missing, install it:

Without secret-tool, passwords are still encrypted, in a file in your home folder (see chapter 15). If, at the first password, the keyring asks you to choose a password to protect it, answer within a minute: otherwise Albatros uses the encrypted file.

2.3 macOS

  1. Download Albatros-1.0.0-beta.12-osx-arm64.dmg and double-click it: a window opens with Albatros.app, the Applications shortcut, the manuals and the license. (With the Albatros-1.0.0-beta.12-osx-arm64.tar.gz archive it is the same: double-clicking it makes Albatros.app appear.)
  2. Drag Albatros.app onto Applications (the Applications folder). Then you can eject the "Albatros 1.0.0 beta 12" disk.
  3. If the package is not signed and notarized by Apple, macOS blocks it the first time. To open it:
    • macOS 15 (Sequoia) and later: try to open it once. Then go to System Settings → Privacy & Security, scroll to the bottom and click Open Anyway next to "Albatros".
    • macOS 14: right-click (or Control-click) Albatros → Open → Open.
    • Alternatively, from Terminal: xattr -dr com.apple.quarantine /Applications/Albatros.app
  4. The first time Albatros saves a password, macOS may ask for access to the Keychain: choose Always Allow.

2.4 Updating and uninstalling


3. First start

The window opens immediately, even with a lot of mail: the archive loads in the background.

If you have no accounts yet and Thunderbird is installed on the computer, Albatros finds it and offers to import accounts, address books and mail ("Thunderbird is installed on this computer: …"). If there is no Thunderbird but there is an Outlook data file (.pst), it offers that instead. Click Import… to choose what to bring over (see chapter 12), or Not now.

As long as there are no accounts, the left pane shows Add account, Import from Thunderbird… and Import from Outlook….

Language. Albatros starts in the language of your operating system, if it is one of the nine available (otherwise in English). To change it: Settings → General → Language. The choice applies to menus, windows, dates and numbers, and takes effect the next time you start Albatros. In Arabic the whole window runs from right to left.


4. Adding a mail account

Settings → Accounts → Add account (or the button in the left pane, as long as there are no accounts).

  1. Type your Email address. Albatros recognizes the provider and fills in the servers by itself:
    • common providers (Gmail, Outlook.com/Hotmail, Libero, Tiscali, Yahoo, iCloud…): immediately;
    • any other domain: Albatros looks up the settings online in a few seconds ("Looking up the server settings online…"). It uses the domain's automatic configuration, the Mozilla database and DNS records (MX, SRV, Microsoft Autodiscover: it recognizes Microsoft 365, even behind a spam filter, and on-premises Exchange). Only the domain is sent over the network, never your address.
  2. Choose how to sign in:
    • Gmail / Google Workspace: two cyan buttons, side by side, let you choose how to sign in. Sign in with Google opens your browser to give consent. Use an app password (the chosen option shows a ✓) shows the instructions and the password field: you need a Google app password, a 16-letter code, not the password you use to sign in to Gmail; the Open the Google page button takes you where you create it. If Google shows "Google hasn't verified this app", click Advanced → Go to Albatros (unsafe) and then Allow: Albatros has not yet completed Google's verification, but your mail stays only on your computer.
    • Outlook.com, Hotmail, Live, Microsoft 365 (work or school): Sign in with Microsoft opens your browser to give consent. Microsoft no longer accepts a password alone for reading mail. For work accounts, the administrator may need to approve Albatros once.
    • All others: enter your password. Yahoo and iCloud require an app password created in their account settings.
  3. Click Verify and save: Albatros tests the connection and, if everything is fine, starts downloading your mail.

Another account already signed in to the browser. With Sign in with Google or Sign in with Microsoft, if you are already signed in to the browser with another account (for example your work account), the consent page may use the wrong one. While the page is open, two buttons appear in the account window:

Outlook.com and IMAP. If, after signing in with Microsoft, the server answers "not connected", IMAP access is probably turned off in Outlook.com: on outlook.live.com open Settings → Mail → Forwarding and IMAP, turn on "Let devices and apps use IMAP", save and try again. Albatros suggests this in the error message.

First synchronization. The first time, Albatros downloads the most recent messages first, so you can read the mail of the last few days right away even if the mailbox is very large; older messages arrive later. The list fills up while downloading, without waiting for the end. The status bar shows the progress: "listing folders…", then, for each folder, "checking messages on the server…".

Fast download. Albatros downloads all accounts together and, for each account, uses several connections at the same time (up to 10 with Gmail and Google Workspace, 4 with other servers): even a single very large folder is split among the connections. If the server does not accept more connections, Albatros carries on with the ones it has. With Gmail, keep in mind that Google lets you download at most about 2.5 GB per day per account: a larger mailbox arrives over two or more days, and Albatros resumes where it left off.

Server settings: opening this section you can correct the server, port, security (SSL/TLS, STARTTLS, or "None (not recommended)") and user name by hand, both for receiving and for sending (SMTP). If the outgoing server wants a user name and password different from the incoming ones (this happens with some company or relay servers), enter them in Username for sending and Password for sending; left empty, the incoming ones are used. This password is also kept in the system's secure store.

Signature for this account: normally all accounts use the signature in Settings → Composition. With Use a separate signature for this account the account has its own (for example the office one on one address and the association one on another); if you leave the text empty, this account's messages are sent without a signature.

IMAP or POP3. In Server settings → Incoming you choose the protocol. IMAP (recommended) keeps your mail on the server and keeps it in sync with your phone and other computers. POP3 downloads messages once into the Inbox of this computer, as Thunderbird does; the account's folders are local. With POP3 two options appear: Leave a copy of messages on the server and Remove the copy from the server after this many days (0 = never). If you untick the first one, messages are deleted from the server as soon as they are downloaded.

Server settings → Incoming: IMAP, POP3, Microsoft Graph or JMAP
Server settings → Incoming: IMAP, POP3, Microsoft Graph or JMAP

Invalid certificate: if the server presents a certificate that has expired, is self-signed or is issued to a different name, Albatros stops and shows the problem and the certificate's fingerprint. Accept it (Accept this certificate and retry) only if you are sure the server is the right one, for example because your provider confirms the fingerprint. If the certificate changes one day, Albatros asks again.

Managing accounts (Settings → Accounts):

The "Add account" window: with a Gmail address, "Sign in with Google" appears
The "Add account" window: with a Gmail address, "Sign in with Google" appears
Settings → Accounts: order, editing, activation and import of the accounts
Settings → Accounts: order, editing, activation and import of the accounts

5. The main window

The main window: folders with the number of unread messages, list with colored tags, attachment paperclip and unread dot, preview at the bottom
The main window: folders with the number of unread messages, list with colored tags, attachment paperclip and unread dot, preview at the bottom
The Tools menu: all attachments, free up space, outbox, RSS feeds and newsgroups
The Tools menu: all attachments, free up space, outbox, RSS feeds and newsgroups

New mail arrives by itself: in real time if the server supports it (IMAP IDLE), otherwise with a periodic check (every 5 minutes; you can change this in the settings). Get mail (F5) checks right away. While mail arrives the list is updated, but the selected message stays selected, the preview does not change and an open right-click menu stays open.

New-mail notification. When new messages arrive in the Inbox, a system notification appears (the notification center of Windows, macOS or the Linux desktop): "New mail from …" with the subject, or "3 new messages" if several arrive together. On Windows and Linux, clicking the notification brings Albatros to the front on the Inbox of that account. Old mail downloaded the first time, or imported from Thunderbird and Outlook, is not announced. You can turn it off in Settings → Synchronization → Notify new mail.


6. Reading mail

An attached photo is previewed below the text of the message
An attached photo is previewed below the text of the message
An attached PDF: the first page, small, in the attachment button, next to it "Download all attachments" and at the top "Add to calendar" (the large page is further down, below the text)
An attached PDF: the first page, small, in the attachment button, next to it "Download all attachments" and at the top "Add to calendar" (the large page is further down, below the text)

6.1 RSS and Atom feeds

Albatros also reads news from websites, like email. Tools → Add an RSS feed… and paste the feed address or, more simply, the website address: Albatros looks for the feed in the page. The feed becomes a folder under RSS, in the left pane; each article is a message, with title, text and a link to the original, and you can search it like the rest of your mail. Feeds update by themselves every half hour.

Right-click a feed folder: Update feeds now and Unfollow… (the folder disappears with its articles: move the ones you want to keep first).

Podcasts. Podcast episodes are feeds with an audio file attached. At the bottom of the article there is one line per file, with an icon (🎧 audio, 🎬 video, 🖼 image), the name and the size: a click opens it in the system's program. Albatros does not download the file by itself, because an episode weighs tens of MB.

Mastodon. To follow a Mastodon profile (or one on another fediverse server), type its address in Add an RSS feed… as @user@server (for example @albatros@mastodon.social), or the address of its page. Posts have no title: Albatros uses the first words of the text as the subject.

6.2 Newsgroups

Albatros also reads and writes in newsgroups (Usenet, NNTP). Tools → Newsgroups…:

  1. New server: the server address and port, user name and password if needed, and the Name in articles and Address in articles you sign your posts with. Save and test checks the access; the password stays in the system's secure store.
  2. Search the server's groups: type part of the name (for example comp.lang) and press Search. For each group you see how many articles it has and whether it is read only.
  3. Subscribe: the group becomes a folder under News, with the latest articles. New articles arrive by themselves.

Articles are read like email and grouped into conversations. Above an article, Reply to group opens the compose window with the Groups field instead of the recipients: the reply goes to the group, not by email. For a new article: right-click the group folder → Write to the group…. From the same menu: Update groups now and Unsubscribe from the group… (the folder disappears; the articles stay on the server).

6.3 Chat

The Chat tab gathers all conversations in one place: on the left the list, most recent first, with the last sentence and the number of unread messages; on the right the messages as bubbles, yours on the right. Type in the box at the bottom: Enter sends, Shift+Enter starts a new line. Opening a conversation marks it as read. Groups and rooms have the 👥 icon.

The Chat tab: a Delta Chat group with the messages as bubbles
The Chat tab: a Delta Chat group with the messages as bubbles

Delta Chat (over email). Chats compatible with Delta Chat are ordinary emails, so no new account is needed. New chat… at the bottom of the list asks for the account, one or more addresses and, for a group, its name. Whoever uses Delta Chat on the phone sees the messages as a chat, whoever uses a mail program sees them as emails. When everyone has the key (Autocrypt, exchanged by itself after the first messages), the messages are encrypted. Albatros looks for chats in the Inbox, in Sent and in the «DeltaChat» folder. The first time, with a very large archive, the search takes a while; after that it is ready at once.

The other chats are added from the Tools menu. They stay connected while Albatros is open and reconnect by themselves if the network drops; their messages stay on the computer. Passwords and tokens are kept in the system's secure store, like those of your mail.

Tools → IRC…: servers, channels and connection status
Tools → IRC…: servers, channels and connection status

7. Writing and replying

The window for writing a reply, with the original message quoted
The window for writing a reply, with the original message quoted
Forwarding an email with a PDF: the attachment button shows a thumbnail of the first page, to check it is the right file
Forwarding an email with a PDF: the attachment button shows a thumbnail of the first page, to check it is the right file

8. Organizing mail

Every action is shown immediately and carried over to the server in the background. It works offline too: the changes are sent as soon as the connection is back.

Right-click a message → Tag: the tags with their color and shortcut key
Right-click a message → Tag: the tags with their color and shortcut key
Settings → Tags: name, color and order of the tags
Settings → Tags: name, color and order of the tags
Free up space: the largest mail, the senders that take the most space and duplicate attachments
Free up space: the largest mail, the senders that take the most space and duplicate attachments
Settings → Rules: the rules for new mail, in their order
Settings → Rules: the rules for new mail, in their order

9. Searching

Search results: the box at the top, the results in the list and the message in the preview
Search results: the box at the top, the results in the list and the message in the preview

Type in the "Search mail" box in the center of the top bar (Ctrl/Cmd+F): results appear as you type, across all accounts, most recent first. If there are more than 500, the list shows the 500 most recent and the status bar says how many were found in total ("the 500 most recent of 3,200 results"): add a word or a filter to narrow it down. Esc clears the search and returns to the folder. If you forget the syntax, hover over the box: the tooltip summarizes it. The search looks at sender, recipients, subject, text and also attachment names: quote also finds messages with an attachment "Quote_system.pdf". The search keywords (da:, oggetto: and so on) are written in Italian:

TypeFinds
invoice smithmessages containing both words
invoice OR quoteat least one of the two
-newsletterexcludes messages with that word
inv*words starting with "inv"
"order confirmed"the exact phrase
da:smith · a:laurain the sender (from) / in the recipients (to)
oggetto:offer · corpo:pricein the subject / in the body
john.smith@example.comthe full address
ha:allegatoonly messages with attachments
non:lettoonly unread messages
cartella:inbox · account:gmailin a folder / in an account
dopo:01/09/2026 · prima:31/12/2026after / before a date (day/month/year)

Case and accents do not matter. In the Calendar tab the same box searches events.

Saved searches. A search you make often (for example da:bank ha:allegato or non:letto cartella:inbox) can be saved: while it is in the box, Save search appears; choose a name and the search appears in Saved searches, in the left pane. A click runs it again, always up to date, like a folder. Right-click: Rename…, Edit the search… and Delete the search (the messages are not touched).

Words that are not searched. Very common words (the, and, il, che…) are left out of the index, to keep it small and fast. In Settings → Search and index you can add others in Words not to search (for example greeting formulas) or put some back in Words to search anyway. They apply to messages arriving from then on; for all the others press Rebuild the index.


10. Calendar

The calendar in Week view, with the Work and Personal calendars
The calendar in Week view, with the Work and Personal calendars
The Month view
The Month view

Calendar tab.

10.1 Tasks

The Tasks tab, with a task open
The Tasks tab, with a task open

Tasks tab: the things to do, divided into lists (on the left). Type in the "New task" box and press Enter; the checkbox next to a task marks it as done (Show completed ones too shows them again). A click on a task opens its card on the right: Title, Due (or No due date), Priority (High, Medium, Low) and Notes.


11. Address book

Albatros does not ask you to fill in an address book by hand: it builds it from your mail, from the people who write to you and above all from the people you write to. It is used for suggestions while you type recipients: the most frequent and most recent people come first.

Added to this are the contacts imported from the Thunderbird address book or from Outlook (see the next chapter), which provide the correct names and take priority in suggestions.

Online address books. In Settings → Contacts → Link an address book you can also link the address books you keep online:

The contacts are included in the recipient suggestions and are read again every 6 hours (Update now does it right away). You edit them on the service, which stays the real address book; Unlink removes them from Albatros, while they stay on the service.


12. Importing from Thunderbird and Outlook

12.1 Thunderbird

Settings → General → Import from Thunderbird…, or the same button in Settings → Accounts and, as long as there are no accounts, in the left pane.

  1. Choose the Profile: Albatros finds the installed ones by itself. With Browse… you can point to the folder of a profile copied from another computer or of a portable Thunderbird.
  2. Choose the accounts: for each one you see its type (IMAP or POP3) and server. New accounts are already ticked. For an account already in Albatros the checkbox means "look for its messages in Thunderbird and import the ones that are missing": useful if you see fewer messages in Albatros than there were in Thunderbird.
  3. Choose What to import:
    • Account settings only: for each account the account window opens already filled in with Thunderbird's servers; you only need the password (or "Sign in with Google" / "Sign in with Microsoft"). Passwords are not imported. The mail of IMAP accounts then arrives from the server by itself.
    • Settings and the mail that exists only on this computer: in addition, the mail of POP3 accounts is copied and, if you want, that of the Local Folders. Copies of IMAP accounts are never copied: that mail is on the server.
    • The address book, with the number of contacts: contacts with the same email address are merged with the ones you already have.
  4. Import. The mail arrives under "Thunderbird" with the same folders, tags and read/flagged status, and can be found right away with search. You can Stop at any time: next time the import resumes where it left off.

No duplicates: a message already in Albatros, even because it was downloaded by an account, is not imported a second time, and accounts already present are not added again. During the import, synchronization with the servers is paused and restarts by itself at the end.

The "Import from Thunderbird" window: the accounts, what to import and the address book
The "Import from Thunderbird" window: the accounts, what to import and the address book

Removing an import: right-click the "Thunderbird" (or "Outlook") archive in the left pane → Remove imported archive…. All imported messages and their folders are removed from Albatros; the accounts and their mail are not touched, and the originals stay in Thunderbird. Afterwards you can import again from scratch.

Thunderbird is never modified. To get the most recent data, close Thunderbird before importing (Albatros warns you if it is open).

12.2 Outlook

Albatros reads the Outlook data file (.pst) of classic Outlook: Settings → General → Import from Outlook…, or the same button in Settings → Accounts and, as long as there are no accounts, in the left pane. At the first start, if there is no Thunderbird but there is an Outlook file, Albatros offers to import it by itself.

  1. Choose the file: Albatros finds those in Outlook's usual folders. With Browse… you can point to any .pst file, even one copied from another computer.
  2. Choose the folders to import: each one shows its number of items. Outlook's calendar and tasks appear in the list but, for now, are not imported.
  3. Import. The mail arrives under "Outlook" with the same folders and read/flagged status, and search is ready right away; contacts go into the Albatros address book. You can Stop at any time: next time the import resumes where it left off, without duplicates.

The Outlook file is not modified. .ost files (the local copy of Exchange and Microsoft 365 accounts) are not imported: that mail is on the server, just add the account. If Outlook is using the file, close Outlook and reopen the import window. Outlook accounts are not imported: add them to Albatros as described in chapter 4.


13. Backup and transfer to another computer

Settings → General → Backup and transfer to another computer.

Use it also as a regular backup: keep the file on an external disk or in the cloud.

The suggested file name is albatros-backup-YYYY-MM-DD.zip, with the current date.

Export configuration… (on the same page) saves only settings and accounts, in a small file (albatros-config.json). Import a configuration… brings them to another computer; the accounts arrive without passwords, which you enter in Settings → Accounts.


14. Settings

SectionWhat it contains
Generalinterface language; mail folder with Change folder…; import from Thunderbird and Outlook; backup and transfer; export/import configuration
Accountsadd, edit, enable/disable, reorder, remove; IMAP or POP3; import from Thunderbird and Outlook
Contactslinked online address books (Google, Microsoft, CardDAV): link, update, unlink
AppearanceAutomatic/Light/Dark theme; three-pane layout or with messages in a separate window
Readingmark as read on opening, show HTML, warning about suspicious senders, trusted senders for images
Tagsname, color and order of the tags (the order decides the 1–9 keys); new tags; deleting; tags coming from other programs
Rulesthe rules on new mail: new, edit, order, on/off, delete
Compositiontext signature, HTML or image signature, quoting the original message in replies, forgotten attachment check, seconds of Undo send, templates
Search and indexhow many messages are in the index and how much space it takes; Rebuild the index; words not to search and words to search anyway
Synchronizationcheck interval, real-time mail (IMAP IDLE), notification for new mail
Calendarstart view, default reminder, reminder sound, desktop notifications
Security and privacywhere passwords are kept; OpenPGP keys and Autocrypt; S/MIME certificates and "Always sign messages"; link to trusted senders
AdvancedAutomatic updates and Check now; data folder (with Open the folder), Protocol log (IMAP and SMTP) for support (off by default), version of the program, of .NET and of the operating system

Every change takes effect immediately. Many sections have Restore defaults.

Settings → General
Settings → General
Settings → Appearance: theme and window layout
Settings → Appearance: theme and window layout

15. Security and privacy

Settings → Security and privacy
Settings → Security and privacy

16. Signing and encryption: OpenPGP and S/MIME

Albatros can sign messages, so that whoever receives them knows they come from you and that nobody has changed them, and encrypt them, so that only the recipients can read them. It supports both systems in use, with no add-ons needed:

Everything is managed in Settings → Security and privacy.

16.1 Your OpenPGP key

16.2 S/MIME certificates

16.3 Signing and encrypting a message

The compose window has two buttons:

Albatros chooses the system: it prefers OpenPGP and uses S/MIME when only S/MIME covers all recipients, or when you only have a certificate to sign with. It never mixes the two systems in one message. Drafts stay unencrypted; in the Sent folder the copy stays readable for you.

16.4 Reading a signed or encrypted message

Above the text a box tells you about the message:

BoxMeaning
green, "✔ Signed by …"the signature is valid: the message comes from that sender and has not been changed
green, "🔒 Encrypted message: opened with your key." (or "…with your certificate.")Albatros has opened it for you
yellow, "? Signed by …"the signature cannot be verified: you don't have the sender's key (import it), or the certificate is not trusted
yellow, valid signature with an Autocrypt keythe key came with the sender's messages: to be sure, compare the fingerprint with them
red, "✖ Signature NOT valid"the message has been modified, or the signature is not theirs: be careful
red, "Encrypted message: it cannot be opened."it is encrypted for a key or certificate that you don't have on this computer

Albatros recognizes both the PGP/MIME format and "inline" PGP (text between -----BEGIN PGP MESSAGE----- lines).


17. Where your data is stored

Settings, accounts, passwords (Windows/Linux)Mail, calendars, log
Windows%APPDATA%\Albatros%LOCALAPPDATA%\Albatros
Linux~/.config/Albatros~/.local/share/Albatros
macOS~/.config/Albatros~/Library/Application Support/Albatros

18. Keyboard shortcuts

On macOS use Cmd (⌘) instead of Ctrl: the menus already show it. The full list is also in Albatros: the About icon (the question mark at the top right) → Keyboard shortcuts….

KeyAction
Ctrl+Nnew message
Ctrl+R / Ctrl+Shift+Rreply / reply all
Ctrl+Lforward
Ctrl+Fsearch
Ctrl+Zundo the last action on messages (inside a text field it undoes the last text edit instead)
Ctrl+,settings
F5get mail
Enteropen the message (in a separate window)
Deldelete (to Trash)
Mmark as read / unread
Ctrl+Shift+U"Unread": unread messages only (on / off)
1 … 9add or remove tag 1–9 (1 Important, 2 Urgent, 3 Work, 4 Personal, 5 To Do, 6 Later)
0remove all tags
Ctrl+S(composing) save draft
Ctrl+Enter(composing) send · (event) save
Enter(in the search box) search right away
Escclose the compose window, the event window or a message opened separately · clear the search
← → · T(calendar) previous / next period · today
Ctrl+C · Ctrl+A(reading) copy · select all
The "Keyboard shortcuts" window, from the question mark at the top right
The "Keyboard shortcuts" window, from the question mark at the top right
The "About" window: version and author
The "About" window: version and author

19. Troubleshooting

"Incorrect user name or password." Check the password. Gmail, Yahoo and iCloud with a password require an app password. Gmail and Microsoft work better with "Sign in with Google" / "Sign in with Microsoft".

"Microsoft refused access" with a work account. The Microsoft 365 administrator must approve Albatros for the organization and have IMAP enabled for your mailbox.

Outlook.com: the server answers "not connected". IMAP access is turned off in the mailbox: see chapter 4 (outlook.live.com → Settings → Mail → Forwarding and IMAP).

The browser opens the wrong account. During "Sign in with Google" / "Sign in with Microsoft", use Open in a private window or Copy link in the account window (see chapter 4).

"Server … unreachable" / "The server is not responding." Check the connection, the server name and the port (Settings → Accounts → Edit…). Changes made offline stay queued and are sent later.

Gmail: a large mailbox downloads halfway and then gives an error. Google lets you download about 2.5 GB per day per account via IMAP. Beyond that, it refuses access until the next day and the orange triangle appears on the account: you don't need to do anything, the next day Albatros resumes where it left off.

Google Calendar: orange triangle with "Google refused access to the calendar (error 403)". Google does not let Albatros read the calendar: usually the permission was removed from the Google account. Delete the calendar (right-click → Delete: the events stay on Google) and connect it again with Connect a calendar… → Sign in with Google. The same applies if the reason is "Google's permission for the calendar has expired or was revoked".

Microsoft 365 calendar: orange triangle with "Microsoft refused access to the calendar (error 403)". For a work account the approval of the Microsoft 365 administrator is often needed. If the reason is "Microsoft's permission for the calendar has expired or was revoked", delete the calendar (the events stay on Outlook) and connect it again.

The update did not start. Albatros stays at the version you have and says so in the status bar. The account of what happened is in the aggiornamento.log file in the log subfolder (see Need help? below). If the new version failed to open, Albatros has already put the previous one back. You can always update by hand as in chapter 2.4.

I don't see the notifications. On Windows check Windows Settings → System → Notifications (notifications must be on and "Do not disturb" off); on macOS System Settings → Notifications → Script Editor. In Albatros, Settings → Calendar → Test notification shows an example.

Sent messages do not end up in Sent (or drafts are not saved). The server does not say which folder is which and the name is not among those Albatros recognizes: right-click the right folder → Use as → Sent (or Drafts). See chapter 8.

A message has disappeared from the Inbox. If you snoozed it, it is in Snoozed, in the left pane, until the chosen time (Bring back now brings it back right away). Otherwise check whether a rule moved it (Settings → Rules).

A sent message has not left yet. Look at the Outbox (Tools → Outbox): it may be scheduled for later, waiting for the connection or rejected by the server; Send now sends it right away.

Newsgroups: "The server … does not accept articles (read only)". The newsgroup server only allows reading: to write you need a server (or a subscription) that accepts articles.

Synchronization seems stuck. Look at the cyan bar at the bottom right: as long as it is there, the round is in progress (hovering shows the folder and the count). Checking mailboxes with tens of thousands of messages can take a few minutes. Stop stops it; what has already been downloaded is kept.

"Missing credentials". This happens after a restore on another computer or an import: open Settings → Accounts → Edit… and enter the password (or "Sign in again with Google" / "Sign in again with Microsoft").

Invalid certificate. Read chapter 4: accept it only if you are sure about the server.

"To sign you need a certificate of your own for …". The account you are writing from has neither an OpenPGP key nor an S/MIME certificate: create one or import it in Settings → Security and privacy (see chapter 16).

"To encrypt you need each recipient's OpenPGP key or S/MIME certificate." The message lists who it is missing for. Ask that person for their public key (or a signed message from them) and import it, or turn off Encrypt.

"Encrypted message: it cannot be opened." It is encrypted for a key or certificate that you don't have on this computer. If you have it on another computer, put it back into Albatros from the backup copy or from the .p12 file.

The password of the .p12 file or of the key is not accepted. You need the password the file was exported with (for a GnuPG or Thunderbird key, its passphrase), not your mail password.

The program does not open on macOS. See 2.3 (Privacy & Security → Open Anyway).

Albatros is already open. It can be open only once per archive: if you start it again, the window that is already open comes to the front.

Need help? If the problem concerns the connection to a server, first turn on Settings → Advanced → Protocol log (IMAP and SMTP) and repeat the operation. Then, still in Settings → Advanced, open the data folder: the log subfolder contains the log (albatros.log). Attaching it to a report helps to understand the problem. It contains no passwords or message texts. If Albatros seems slow, the log also tells you where: interface waits longer than half a second and operations that stayed queued for a long time are written with their name (for example "interfaccia ferma 820 ms durante: elenco di INBOX"; the log is written in Italian).


Albatros · © 2026 Arato Ingegneria